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Papers  in  this  series  have  resulted  from  technical  activities  of  the 
Hydrologic  Engineering  Center.  Versions  of  some  of  these  have  been 
published  in  technical  journals  or  in  conference  proceedings.  The 
purpose  of  this  series  is  to  make  the  information  available  for  use  in  the 
Center’s  training  program  and  for  distribution  within  the  Corps  of 
Engineers. 


The  findings  in  this  report  are  not  to  be  construed  as  an  official 
Department  of  the  Army  position  unless  so  designated  by  other 
authorized  documents. 


The  contents  of  this  report  are  not  to  be  used  for  advertising, 
publication,  or  promotional  purposes.  Citation  of  trade  names  does  not 
constitute  an  official  endorsement  or  approval  of  the  use  of  such 
commercial  products. 
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INTRODUCTION  AND  OVERVIEW 

The  methodology  and  difficulties  in  converting  a  large,  general 
purpose,  mainframe,  batch  oriented  computer  program  (for  reservoir 
simulation)  to  work  effectively  in  the  PC  environment  are  described  in 
this  paper.  A  brief  overview  of  the  present  capabilities  of  the  general 
purpose  reservoir  simulation  program  (HEC-5),  that  works  on  mainframe  and 
MS  DOS  compatible  computers,  is  also  presented. 

Major  aspects  of  the  conversion  to  the  PC  environment  are  presented, 
including  the  transformation  of  large  subroutines  written  in  FORTRAN  IV, 
to  a  modular  style  in  FORTRAN-77.  Experiences  with  various  Fortran 
compilers  and  techniques  for  memory  management  (considering  the  limited 
memory  space  available  on  the  PC)  are  also  presented.  Overlaying  and 
memory  caching,  used  as  implementation  techniques  for  the  PC,  are 
discussed.  Discussion  includes  using  extended  memory  on  the  PC,  which 
allows  the  program  to  operate  in  a  non-overlaid  form  at  speeds  comparable 
to  the  HARRIS -1000  super  minicomputer.  Results  showing  the  performance  of 
the  program  as  related  to  the  HARRIS -1000  and  various  PC's  are  shown. 

The  recent  enhancements  to  provide  interactive  execution  of  various 
utility  programs  for  HEC-5  are  discussed.  These  programs  include:  checking 
input  data  (CKHEC5) ;  interactive  input  preparation  (INFIVE);  input 
modification  (MODFIV) ;  handling  program  executions  (MENU5) ;  and 
interactive  output  displays  from  HEC-5.  Special  "user  friendly"  features 
depicting  spatial  displays  of  input  data  and  simulation  results  are  shown. 


BASIC  PROGRAM  OVERVIEW 

The  program  "Simulation  of  Flood  Control  and  Conservation  Systems" 
(abbreviated  HEC-5)  was  initially  developed  in  1972  utilizing  large 
storage,  high  speed  mainframe  computers.  Later  versions  of  the  program 
have  been  issued  about  once  per  year  since  1979.  The  first  PC  version  was 
released  in  1987.  The  April  1988  version  of  HEC-5  and  the  latest 
companion  programs  consist  of  the  following  number  of  subroutines  and 
lines  of  source  code  (including  about  60  percent  comment  cards) . 
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Number  of 
Subroutines 


Lines  of  code 
Total 


HEC5A 

169 

86,000 

HEC5B 

30 

10,000 

CKHEC5 

28 

9,600 

IN5 

23 

10,800 

MODS 

47 

25,000 

MENU  5 

IQ 

1.600 

Total 

307 

143,000 

The  HEC-5  program  was  developed  to  operate  for  one  or  more  reservoirs 
for  flood  control,  hydropower  and  water  supply  for  all  computational  time 
intervals  from  1  minute  to  1  month.  The  capabilities  to  simulate  the 
system  for  flow  sequences  up  to  2000  time  periods  in  length  and  for 
chaining  these  sequences  together  (for  the  same  or  different  computational 
time  intervals)  were  developed.  Optimization  routines  are  available  to 
size  single  reservoir  conservation  storage  or  yields  for  hydropower,  water 
supply  or  irrigation  or  for  combinations  of  these  for  routing  intervals 
from  1  day  to  1  month.  For  flood  control  evaluations,  seven  different 
hydrologic  routing  techniques  can  be  utilized  to  account  for  the  stream 
flow  routing  effects  (attenuation  and  delay).  The  HEC-5  program  is  being 
used  by  over  20  Corps  of  Engineers  offices  and  20  non-Corps  offices  based 
on  information  from  an  October  1986  questionnaire  mailed  to  all  of  the 
offices  on  HEC's  mailing  list  of  HEC-5  source  code  holders.  The  offices 
responding  represent  over  150  users  who  are  using  HEC-5  on  the  following 
computers:  Harris,  CDC,  IBM,  Honeywell,  Amdahl,  Vax  and  several  others. 
The  following  types  of  studies  are  being  performed  by  these  offices  each 
year:  25  flood  control;  20  hydropower;  23  water  supply;  7  real-time  flood 
control;  and  4  irrigation. 


Documentation  for  the  HEC-5  package  of  programs  includes:  user 
manuals;  PC  implementation  guides;  structural  flow  charts;  and  listings 
of  program  variable  use  by  subroutine  name,  statement  number  and  type  of 
Fortran  statement. 


MODERNIZATION  OF  SOURCE  CODE 


The  HEC-5  program  has  been  developed  over  a  16  year  period  on  six  or 
more  mainframe  and  mini -computers  under  many  operating  environments  and 
Fortran  compilers.  The  scope  of  the  program  has  changed  from  a  simple 
flood  control  system  to  a  highly  complex  multi-purpose,  multi-reservoir, 
multi-flood  simulation  tool. 


Due  to  the  importance  of  minimizing  program  support  costs,  reducing 
program  malfunctions,  and  facilitating  new  improvements,  a  decision  was 
made  in  1984  to  modernize  the  source  code.  This  modernization  effort 
greatly  assisted  in  the  eventual  conversion  to  the  PC.  The  modernization 
process  involved  the  following  general  steps: 


a.  Modularize  -  In  order  to  obtain  a  modular,  top  down  design 
for  HEC-5,  structural  flow  charts  were  developed  and  large 


subroutines  were  divided  into  smaller  logical  subroutines.  HEC-5 
has  always  been  composed  of  two  parts:  HEC5A,  the  simulation  part; 
and  HEC5B,  the  output  and  economic  analysis  part.  The  12  major 
subroutines  in  HEC5A  were  converted  into  102  new  subroutines.  In 
addition  to  physically  making  smaller  subroutines,  many  comment  cards 
were  added  to  explain  the  program  organization  and  to  clarify  the 
logic  within  the  new  subroutines.  Also,  an  ongoing  effort  is  being 
made  to  reduce  the  number  of  temporary  variables  and  to  give  them 
more  meaningful  names . 

b.  *Comdecks  -  Source  code  which  is  common  to  many  subroutines, 
such  as  PARAMETER  statements  and  COMMON  BLOCKS,  have  been  placed  into 
separate  files.  These  files  are  added  to  the  source  code  during  an 
update  process  or  by  the  compiler  at  compile  time.  This  activity  is 
accomplished  on  the  PC  by  the  INCLUDE  statement,  while  the  Harris 
uses  an  update  process  called  Historian  (Opcode , 1987)  which  uses 
*Comdecks  to  include  these  files.  The  *comdeck  approach  was  used  for 
PARAMETER  statements  as  well  as  for  subroutine  COMMONS  and  for  most 
subroutine  arguments.  Using  this  approach  a  new  variable  can  be 
added  to  a  subroutine  argument  string  and  this  modification  is 
propagated  throughout  the  source  code  such  that  all  calls  to  that 
subroutine  reflect  the  modified  argument  string. 

c.  Dimension  limits  -  HEC-5  contains  about  250  arrays  resulting 
in  extensive  computer  memory  requirements.  Many  of  the  arrays  have 
the  same  dimension  limits  such  as  maximum  number  of  control  points, 
reservoirs,  and  time  periods.  Since  some  computer  systems  may 
require  that  these  limits  be  changed,  it  was  desirable  to  use 
PARAMETER  statements  in  the  source  code  for  36  parameter  variables 
so  that  the  dimension  limits  can  be  changed  easily.  Limits  of  all 
logic  loops  dealing  with  these  arrays  are  also  keyed  into  these 
parameter  variables.  The  PARAMETER  statements  are  now  all  contained 
in  a  single  *comdeck  file  which  is  brought  into  the  subroutine  during 
either  the  update  or  compilation  phase.  Thus,  by  editing  one  number 
in  the  PARAMETER  statement  and  recompiling  routines  that  contain  the 
edited  parameter  statement,  most  key  dimension  limits  can  be  easily 
changed. 

d.  COMMON  Blocks  -  Prior  to  1982,  most  variables  were  contained 
in  one  of  several  large  COMMON  blocks  that  were  included  in  almost 
all  subroutines.  A  major  effort  was  made  in  1982  to  revise  the 
COMMON  blocks  and  to  eliminate  the  major  common  blocks  in  all  but  a 
few  major  subroutines. 


e.  Centralize  and  Simplify  Kev  Logic  -  Several  new  subroutines1  For 
were  developed  in  an  attempt  to  centralize  all  ) jgic  dealing  with  .*1 
certain  functions  in  order  to  simplify  the  program  logic.  Several 
key  routines  were  also  rewritten  because  the  logic  had  become  too  ed 


difficult  to  understand  based  on  years  of  new  improvements  and  error  tlo 


corrections . 
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f.  Trace  Output  -  Diagnostic  output  of  intermediate  results 
showing  internal  computations  within  the  various  subroutines  is  an 
important  part  of  HEC-5.  The  modernization  activity  enhanced  this 
output  by  including  variable  name  labels  above  all  numeric  values 
along  with  subroutine  name  and  statement  number  where  the  output 
originated. 


VI 


g.  FORTRAN -77  -  In  order  to  make  the  HEC-5  FORTRAN  program  easily 
transportable  from  one  computer  system  and  compiler  to  another,  the 
source  code  was  converted  and  updated  to  meet  the  ANSI  FORTRAN- 77 
standard  (ANSI,  1978).  A  major  portion  of  the  conversion  process  was 
eliminating  the  usage  of  hollerith  variables  and  constants  in  the 
source  code  and  replacing  that  usage  with  the  FORTRAN- 77  supported 
character  variables. 
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Once  the  program  was  converted  to  character  usage, the  remainder  of 
the  effort  centered  around  elimination  of  compiler  specific  code  and 
replacing  it  with  its  FORTRAN- 77  counterpart.  In  the  case  of  the 
HARRIS  compiler,  INTEGER*6,  and  SPECIAL  COMMON  were  reserved  FORTRAN 
words  which  had  no  meaning  to  other  compilers.  These  were  removed 
from  the  source  code . 

In  addition  to  changes  required  for  compatibility  with  FORTRAN-77, 
other  changes  which  used  FORTRAN- 77' s  more  powerful  features  were 
also  implemented,  such  as  the  PARAMETER  statement  previously 
mentioned.  The  FORTRAN  IF-ELSE-ENDIF  is  another  example.  When 
source  code  was  being  modified,  this  construct  was  used  to  replace 
many  lines  of  code  which  were  dependent  on  the  same  conditional 
result. 

CONVERSION  OF  HEC-5  TO  THE  PC 

During  the  initial  stages  of  adapting  HEC-5  to  execute  in  the  MS-DOS 
(Microsoft,  1983)  PC  environment,  several  PC-based  FORTRAN  compilers  were 
evaluated.  By  choosing  the  most  appropriate  compiler,  it  was  hoped  that 
the  task  of  creating  a  HEC-5  executable  for  the  PC  could  be  accomplished 
as  quickly  and  efficiently  as  possible.  At  the  time  (early  1987),  four 
well  known  FORTRAN  compilers  were  available  for  use  with  MS-DOS.  They 
included  Microsoft  FORTRAN  (Microsoft,  1985)  (Version  3 . 3)  ,  Ryan -Me far land 
FORTRAN  (Version  2.1)  (Ryan,  1986),  Lahey  FORTRAN  (Version  2.2)  (Lahey, 
1988),  and  Digital  Research  FORTRAN  (Digital,  1986).  Each  of  these 
compilers  showed  strengths  and  weaknesses  when  used  for  the  initial 
compilation  of  the  September  1986  HARRIS  version  of  HEC-5.  Since  HEC-5 
had  just  been  converted  to  ANSI  FORTRAN- 77  standards,  all  aspects  of  the 
program  complied  with  the  full  implementation  of  the  ANSI  FORTRAN-77 
standard.  However,  it  did  not  adhere  to  the  specifications  of  the  more 
restrictive  subset  of  the  FORTRAN-77  standard.  This  meant  that  a  compiler 
which  was  a  full  implementation  of  ANSI  standard  would  be  preferred  to  an 
implementation  of  the  subset.  Several  compilers  were  unable  to  handle 
subroutines  that  contained  over  64  formal  arguments.  At  this  point  in  the 
development  of  the  program,  HEC-5  had  many  large  subroutines  with  this 
characteristic  (this  was  changed  in  1988).  If  the  compiler  chosen  could 
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handle  large  numbers  of  arguments,  less  time  could  be  spent  converting  the 
program  to  an  acceptable  form  for  compilation. 


The  Lahey  compiler  was  chosen  because  it  alone  had  the  full 
implementation  of  the  ANSI  FORTRAN- 77  standard  and  could  accommodate  the 
large  number  of  subroutine  arguments.  Also  noted  at  the  time,  was  that 
this  compiler  was  compatible  with  an  existing  commercial  overlay  linker, 
Phoenix  software's  Plink86  (Phoenix,  1985)  and  could  handle  large  common 
blocks  greater  than  64  thousand  bytes  (64  Kb),  as  well  as  large  local 
arrays . 


MEMORY  CONSIDERATIONS  ON  THE  PC 


After  successfully  compiling  the  September  1986  version  of  HEC-5 
using  the  Lahey  compiler,  the  memory  available  for  linking  and  execution 
of  the  program  became  the  next  important  consideration.  Attempting  to  run 
a  program  in  the  MS-DOS  operating  system  on  an  8088  based  microprocessor 
brings  with  it  several  storage  and  size  constraints  that  must  be  satisfied 
in  order  for  the  program  to  be  able  to  run.  The  first  limit  to  notice  is 
the  1  megabyte  (Mb)  or  1000  Kb  maximum  addressing  available  on  the  8088 
microprocessor.  Unless  the  window  that  the  final  program  executes  in  is 
1  Mb  or  less,  the  linker  will  not  be  able  to  create  an  executable.  The 
second  and  probably  most  well  known  constraint  is  the  640  Kb  maximum  that 
DOS  provides  for  program  execution.  If  the  program  execution  window  is 
less  than  1  Mb  but  greater  than  the  640  Kb  limit,  then  the  microprocessor 
will  be  able  to  run  the  executable,  but  will  be  prevented  from  doing  so 
by  DOS.  The  September  1986  version  of  HEC-5,  if  created  as  one  large 
executable,  would  require  1.2  Mb  of  memory  to  execute.  This  is  not  only 
over  the  640  Kb  required  by  DOS ,  but  also  over  the  1  Mb  addressing  space 
of  the  8088.  Clearly,  something  had  to  be  done  about  the  size  of  the 
executable  in  order  to  allow  the  program  to  operate  on  an  8088  based 
machine  using  MS-DOS. 


Two  steps  were  taken  to  deal  with  minimizing  the  amount  of  memory 
required  for  running  the  program.  First,  dimensional  limits  of  large 
arrays  and  common  blocks  were  reduced,  allowing  for  creation  of  a  smaller 
executable.  The  dimension  limits  were  reduced  for  number  of  time  periods 
(from  2,000  to  200),  number  of  reservoirs  (from  20  to  15)  and  number  of 
control  points  (from  35  to  15).  Secondly,  the  program  was  overlayed  so 
that  the  program  executable  could  reside  in  DOS's  640  Kb  window. 


PROGRAM  OVERLAYING 


One  of  the  criteria  used  in  choosing  the  proper  FORTRAN  compiler  was 
that  it  be  compatible  with  a  linker  that  could  do  program  overlaying. 
Because  Phoenix  Software's  Plink86  linkage  editor  was  not  only  capable  of 
doing  overlaying,  but  was  also  compatible  with  the  Lahey  FORTRAN,  it  was 
chosen  to  link  the  HEC-5  program.  After  a  brief  look  at  various  hardware 
and  software  configurations  of  PC's  at  the  Hydrologic  Engineering  Center, 
a  target  size  for  the  HEC-5A  executable  of  550  Kb  was  chosen.  This  memory 
size  would  require  the  user  to  have  the  full  640  Kb  complement  of  memory 
available  in  the  PC,  but  still  leave  a  little  memory  for  system  device 
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drivers  and  small  ram  resident  utility  programs. 

The  design  of  an  overlay  scheme  could  now  be  undertaken.  Using  the 
map  feature  of  Plink86,  memory  requirements  for  each  of  the  subroutine 
modules  was  determined.  This  information,  coupled  with  the  program  design, 
was  used  to  create  an  overlay  scheme  which  was  as  efficient  as  possible, 
yet  reduced  the  size  of  the  resulting  executable  to  the  550  Kb  target 
size.  Subroutines  overlaid  using  this  scheme  were  required  to  have  all 
ancestor  routines  (those  routines  calling  the  subroutine)  in  memory  with 
the  overlay,  further  complicating  the  overlay  structure.  Since  the  program 
was  already  divided  into  three  distinct  sections,  pre- operation,  operation 
,  and  post-operation  routines,  this  structure  was  also  incorporated  into 
the  overlay  design.  The  diagram  of  the  resulting  overlay  map,  showing  the 
overlay  groups,  can  be  seen  in 

figure  1.  It  should  be  noted  that  well  over  half  of  the  overlay  storage 
requirements  are  devoted  to  the  common  block  storage  area. 

INITIAL  PC  PERFORMANCE 

With  the  development  of  the  September  1986  PC  version  of  HEC-5,  the 
program  performance  of  HEC-5  could  now  be  evaluated  in  the  MS-DOS 
environment.  The  first  machine  used  for  testing  the  program  was  an  Epson 
Equity  III  'AT'  compatible  with  a  80286  microprocessor.  The  machine  was 
equipped  with  640  Kb  ram,  a  1 . 2  Mb  floppy  drive,  a  360  Kb  floppy  drive 
and  a  80287  math  coprocessor.  Although  all  10  standard  test  data  sets 
executed  properly,  the  process  was  much  slower  than  comparable  testing  on 
the  HARRIS  1000.  The  10  standard  tests  which  took  about  8  min  to  execute 
on  the  HARRIS,  took  about  5  3/4  hrs  to  complete  on  the  8  MHz  Epson 
computer  (see  figure  2).  The  same  tests  run  on  a  IBM  XT  8088 
microcomputer  took  approximately  10  1/4  hrs.  Clearly,  the  performance  on 
the  PC  would  have  to  be  enhanced  in  order  for  the  PC  to  become  a  viable 
alternative  to  operating  the  program  on  the  HARRIS  1000  super  mini 
computer. 

OVERLAY  MEMORY  CACHING 

Since  code  developed  for  the  PC  was  heavily  overlayed  and  required 
many  relatively  slow  accesses  to  the  hard  disk  to  perform  each  overlay, 
attention  was  next  focused  on  ways  to  Improve  program  performance  as  it 
related  to  the  overlays,  for  those  users  who  have  or  were  willing  to  buy 
extra  memory,  Either  fewer  overlays  had  to  be  implemented  or  the  overlay 
process  had  to  be  done  faster.  Since  extensive  overlaying  was  required 
just  to  create  the  executable,  speeding  the  overlay  process  was 
investigated.  Plink86  had  just  the  feature  to  accomplish  this  task.  The 
overlay  memory  caching  option  allowed  use  of  the  same  overlay  scheme,  but 
enabled  the  overlay  process  to  occur  at  a  much  faster  rate.  Instead  of 
overlaying  subroutines  from  the  slow  hard  disk,  this  option  enabled 
overlaying  from  extended  memory,  if  available.  As  the  program  is  loaded 
into  memory,  the  overlays  are  copied  into  'high'  memory.  As  each  overlay 
is  needed,  it  is  copied  from  extended  memory  down  to  the  640Kb  DOS 
environment  where  it  is  used.  Program  execution  does  not  have  to  wait 
for  slow  disk  accesses  each  time  a  overlay  is  required. 


After  the  addition  of  1  Mb  of  extended  memory  (costing  approximately 
$400)  to  accommodate  the  large  number  of  overlays,  the  program  was 
relinked  on  the  Epson  computer  with  the  overlay  cache  option.  Subsequent 
evaluation  of  program  performance ,  showed  that  the  overlay  caching  feature 
improved  execution  speeds  by  nearly  a  factor  of  four.  The  10  standard 
tests  which  took  5  3/4  hrs  to  execute  without  overlay  caching,  now  could 
execute  in  1  1/2  hrs  (see  figure  2). 

HEC-5  EXTENDED  MEMORY  OPERATION 

As  the  experience  of  executing  HEC-5  on  the  PC  accumulated,  it  became 
increasingly  apparent  that  mainframe  performance  of  the  program,  both  in 
terms  of  implementation  as  well  as  execution  time  could  be  realized  on  the 
PC.  The  decision  was  made  to  further  improve  the  performance  of  the 
program  in  the  PC  environment.  As  a  next  step,  the  overlay  cache  version 
of  the  program  was  transported  to  a  newer,  faster  PC.  The  new  machine  was 
a  COMPAQ  386  with  a  16MHz  clock  rate  and  a  80387  math  coprocessor.  Again 
performance  of  the  program  improved,  this  time  due  to  the  faster  raw 
processing  speed  of  the  80386.  The  10  standard  tests  could  now  be  executed 
in  approximately  32  min  with  the  overlay  caching. 

At  about  the  same  time,  Lahey  announced  the  distribution  of  an 
extended  memory  FORTRAN  compiler  for  use  on  80286  and  80386  based 
microcomputers.  This  compiler  would  allow  execution  of  large  FORTRAN 
programs  in  extended  memory  without  the  use  of  overlays .  This  announcement 
had  2  implications  on  the  development  of  HEC-5  on  the  PC.  First,  since 
overlays  would  not  be  necessary,  program  performance  should  increase  once 
again.  Secondly,  since  program  size  was  dependent  on  the  amount  of 
extended  memory  available  and  not  on  the  640  Kb  limit  imposed  by  DOS,  the 
entire  mainframe  version  of  HEC-5  could  be  implemented  on  the  PC  without 
compromising  array  sizes  to  obtain  a  smaller  executable. 

Coincident  with  the  development  of  HEC-5  on  the  PC  were  several  major 
enhancements  to  the  mainframe  version  of  HEC-5.  The  most  notable  of  these 
improvements  was  the  addition  of  the  interactive  display  menu  allowing 
users  to  view  intermediate  output  produced  by  the  program.  When  the  new 
version  of  the  program  became  available  in  April  1988,  work  was  started 
immediately  to  implement  the  new  full  mainframe  version  on  the  PC  using 
the  extended  memory  FORTRAN  compiler  from  Lahey. 

The  extended  memory  FORTRAN  compiler  system  allowed  for  greater 
capabilities  of  the  program  in  the  PC  environment.  Not  only  did  it  lift 
the  640  Kb  memory  requirement  of  DOS,  but  it  did  so  without  abandoning 
DOS.  The  extended  memory  compiler  and  OS/286  operating  system,  (A.  I. 
Architects,  1988)  take  advantage  of  the  protected  mode  operation  of  the 
80286  microprocessor  while  maintaining  DOS  compatibility.  The  OS/286  acts 
as  a  supplement  to  DOS  rather  than  replacing  it.  This  means  that  all  the 
DOS  compatible  utility  programs  are  still  available  to  the  user.  OS/286 
is  only  invoked  when  needed  by  the  FORTRAN  executable  at  run  time  of  the 
program.  Upon  completion  of  the  program,  control  is  again  returned  back 
to  DOS . 


CURRENT  STATUS  OF  HEC-5  ON  THE  PC 


Currently,  the  April  1988  mainframe  version  of  HEC-5  is  running  on 
the  COMPAQ  368  PC.  It  is  a  full  implementation  of  the  mainframe  version 
of  the  program,  including  the  interactive  capabilities  of  the  menu  system. 
As  on  the  HARRIS  version,  the  HEC  data  storage  system  (DSS)  is  also 
available  for  obtaining  graphical  displays  of  both  input  and  computed  time 
series  data.  The  program  currently  requires  approximately  2 . 3  Mb  extended 
memory  (plus  500  Kb  for  the  operating  system),  for  use  with  either  a  80286 
or  80386  based  microprocessor.  It  executes  the  10  standard  tests  in 
approximately  18  min.  which  is  just  over  twice  the  execution  time  on  the 
HARRIS  1000  computer. 

Work  is  currently  under  way  to  interface  new  capabilities  to  the  PC 
version  of  the  program  by  the  addition  of  water  quality  subroutines  which 
will  work  in  conjunction  with  the  quantity  subroutines  of  HEC-5A. 

FUTURE  PC  DIRECTIONS 

Due  to  the  success  of  adapting  HEC-5  to  the  PC  environment,  more 
program  development  is  being  planned  for  the  PC.  The  next  step  in  the 
process  of  improving  performance  and  capabilities  of  the  program  is  the 
conversion  of  the  program  from  16  bit  operation  to  32  bit  operation.  By 
recompiling  the  program,  with  Lahey  32 -bit  extended  memory  FORTRAN 
compiler  and  linking  with  the  new  A. I.  Architects  OS/386  operating  system, 
this  conversion  can  be  accomplished.  With  this  conversion,  HEC-5  will  be 
able  to  access  the  full  power  of  the  80386  and  80387  chips.  Data  transfers 
which  currently  occur  in  2  16 -bit  transfers  would  be  replaced  by  1  32 -bit 
data  transfer  yielding  even  further  improvement  in  performance.  Use  of 
the  32 -bit  FORTRAN  compiler  and  OS/386  operating  system  should  allow  the 
PC  to  meet  or  surpass  the  performance  of  the  HARRIS  1000  computer. 

In  addition  to  a  new  32-bit  extended  memory  version  of  HEC-5,  future 
plans  also  include  implementation  of  the  program  in  the  new  OS/2  PC 
operating  system.  With  the  arrival  of  Microsoft  Fortran  (version  4.1)  and 
OS/2  (version  1.0)  development  for  this  new  environment  is  ready  to 
proceed. 

For  users  of  8088  microcomputers  interested  in  running  the  latest 
(April  1988)  version  of  HEC-5,  and  willing  to  sacrifice  performance,  an 
overlayed,  16  bit  version  of  the  program  may  also  be  developed.  This 
version  would  operate  slower  than  the  extended  memory  version  of  the 
program,  but  would  not  require  extended  memory  or  an  80286  or  80386 
microprocessor . 

ENHANCING  BATCH  PROGRAMS  FOR  PC  ENVIRONMENT 

In  early  1987,  versions  of  HEC5A  (simulation  module)  and  HEC5B 
(output  module)  worked  for  the  first  time  on  the  PC  in  the  batch  mode. 
While  these  programs  have  the  same  "user  friendliness"  of  the  mainframe 
computers,  the  PC  environment  offered,  even  demanded,  more  "user 
friendliness".  Therefore,  several  utility  programs  were  developed  (and 


a  few  existing  ones  were  modified)  to  enhance  the  "user  friendliness"  on 
both  the  PC  and  mainframe. 

The  first  program  in  this  category  which  was  assembled  for  this  user 
friendly  environment  was  the  CKHEC5  (CK5)  program.  This  batch  program, 
developed  in  1985,  reads  the  HEC-5  input  data  file  describing  the  user's 
system  and  checks  the  data  to  see  if  it  was  prepared  following  the  rules 
in  the  users  manual.  Possible  error  messages  are  printed  if  potential 
difficulties  are  encountered. 

To  assist  the  user  in  deciding  what  input  data  is  needed  by  HEC-5 
for  particular  reservoir  systems,  a  new  program  called  INFIVE  (IN5)  was 
developed  in  1985  and  1986.  This  interactive  input  program  asks  the  user 
a  number  of  questions  concerning  the  physical  and  operational  makeup  of 
the  reservoir  system  to  be  modeled.  At  the  conclusion  of  the  10-15  minute 
session,  a  skeleton  data  file  in  the  form  of  80  column  card  images  has 
been  developed  to  make  the  HEC-5  simulation.  However,  additional  data 
must  be  supplied  before  a  simulation  can  be  done.  Inputting  values  for 
specific  data  fields  is  accomplished  by  using  either  a  text  editor  and  the 
Exhibit  8  of  the  HEC-5  User  Manual  (Hydrologic  Engineering  Center,  1988) 
or  by  using  an  HEC  editor  called  COED  (Hydrologic  Engineering  Center, 
1987).  In  1987,  COED  was  modified  to  provide  help  files  for  various  HEC 
programs,  including  HEC-5.  The  COED  help  files  provide  either  variable 
names  or  variable  definitions  for  each  data  item  as  it  is  pointed  to  by 
the  screen  cursor. 

In  order  to  allow  occasional  users  of  HEC-5  to  modify  operational 
parameters  during  real-time  flood  control  operations,  a  new  interactive 
program  called  MODFIV  (M0D5)  was  developed  in  1986  -  1988.  This  M0D5 
program  uses  menus  (see  figure  3  for  an  example)  to  display  and  change 
data  representing  all  required  cards  and  all  operational  parameters .  At 
the  conclusion  of  the  interactive  session,  a  new  HEC-5  data  file  is 
available  representing  the  modifications  requested  during  the  interactive 
session. 

The  remaining  link  in  enhancing  the  user  environment  is  to  allow 
these  different  programs  to  be  executed  in  a  user  friendly  manner  from  a 
menu.  Thus,  a  program  called  MENU5  was  developed  in  1987  and  1988  for 
the  PC  which  will  allow  the  following  programs  to  be  executed: 

NAME  PURPOSE 

CK5  Input  Data  Checking  Program  (CKHEC5) 

IN5  Interactive  Input  Preparation  Program  (INFIVE) 

M0D5  Interactive  Input  Modification  Program  (MODFIV) 

COED  Interactive  Editor 

HEC5A  Simulation  part  of  HEC-5  (HEC5A) 

HEC5B  Output  and  Economic  Summary  part  of  HEC-5  (HEC5B) 

DSPLAY  Graphical  Data  Display  Utility  (DSPLAY) 

In  addition  to  executing  the  above  programs  from  a  menu,  MENU5  will 
also  provide  a  convenient  way  to  display  or  print  output  results,  to 
transfer  file  names  among  programs,  and  to  facilitate  naming  the  input 


file.  For  instance,  if  desired,  a  project  name  can  be  input  and  all  files 
required  by  all  programs  will  be  automatically  named.  Also  a  list  of  all 
available  HEC-5  input  files  can  be  used  to  make  the  file  selection  by 
positioning  the  screen  cursor. 

Enhancements  recently  completed  include  interactive  output  displays 
and  interfacing  with  HEC's  Data  Storage  System  (DSS) .  The  April  1988 
mainframe  and  PC  versions  of  the  HEC5A  program  can  now  be  executed  in 
either  the  batch  or  interactive  modes.  In  the  interactive  mode  a  menu 
will  be  displayed  on  the  screen  after  the  simulation  is  complete  (see 
figure  4).  This  menu  will  allow  the  user  to  look  at  various  HEC-5 
standard  output  tables  or  to  create  tables  or  color  plots  (see  figure  5) 
of  any  time  series  data  using  results  which  are  in  memory.  Thus,  the 
operational  results  can  be  quickly  inspected  from  the  MENU  without  needing 
to  display  or  print  large  volumes  of  output.  Two  useful  new  types  of 
output  developed  are  the  schematic  map  of  the  basin,  one  to  display  input 
and  the  other  to  display  output. 

The  HEC-DSS  system  (available  both  on  mainframe  and  PC  versions)  is 
used  for  displaying  time  series  results  in  a  graphical  form  using  the  HEC 
program  DSPLAY.  In  addition,  any  HEC-5  time  series  data  can  be  read  from 
DSS  or  stored  into  DSS.  HEC5A  and  M0D5  currently  work  with  DSS,  while  INS 
and  CKHEC5  do  not  currently  look  for  flow  data  stored  in  DSS. 

CURRENT  PC  PERFORMANCE 

The  September  1986  and  April  1988  versions  of  HEC-5  are  presently  on 
the  PC.  The  1988  source  code  for  the  PC  and  the  mainframe  are  the  same 
except  for  a  few  statements .  Comparisons  between  the  HARRIS  1000  and  the 
PC  versions  are  made  in  terms  of  maximum  limits  of  key  arrays,  memory 
requirements,  FORTRAN  Compilers,  and  execution  speeds  (see  figure  2). 

Maximum  Array  Sizes:  The  maximum  array  sizes  for  key  variables  are 
as  follows: 


Mainframe 

1986  PC 

1988  PC 

Number 

of 

Reservoirs 

20 

15 

20 

Number 

of 

Control  Points 

35 

15 

35 

Number 

of 

Time  Periods 

2,000 

200 

2,000 

Number 

of 

Power  Plants 

12 

9 

12 

Memory  Requirements :  The  execution  times  shown  in  figure  2  are 
highly  dependent  on  the  following  use  of  overlay,  extended  memory  and 
memory  caching  for  the  various  versions: 


Mainframe  198o  PC  1988  PC 


Dynamic  Time  Series  Data 

YES 

YES 

YES 

Overlay  Used 

NO 

YES 

NO 

Extended  Memory 

NO 

NO 

YES 

Overlay  Caching 

N/A 

YES 

NO 

10 


Compilers :  Times  shown  are  the  clock  times  required  to  compile  (all 
169  subroutines)  and  link  the  HEC5A  routines  on  the  compilers  currently 
in  use  with  HEC-5. 


15 


Fortran- 77 
Compiler 

HARRIS  VOS  6.1.0 
LAHEY  FORTRAN 

LAHEY  EXTENDED  MEMORY  FORTRAN 


Compile 
Time  (min) 
15 
25 
25 


Link 

Tiwe  (min) 
2 
15 


MICROSOFT 


45 


* 


*  D  group  size  larger  than  64  kb  link  not  complete 
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®HAX»IS  1000  super  mini computer  (no  other  Jobs  in  system) 


NODS  MENU  FOR  FLOOD  CONTROL  GOALS 

T1  Scioto  River  Basin 


(Menu  N-F) 

FLOOD 

CONTROL  GOALS; 

COLUMN 

-01 
C  P  NAME  MAX  FLOW 

2 

R/C-RIS 

3 

R/C-FAL  HRS 

4 

-FCST 

255R 

DDOD2 

5000. 

1000. 

1000. 

0. 

268 

WOOE2 

5000. 

0. 

0. 

0. 

275 

CLSF4 

20000. 

0. 

0. 

0. 

1 

. ---288R 

ACSE3 

1800. 

300. 

1000. 

0. 

1 

.---290 

CLAF3 

2100. 

0. 

0. 

0. 

1 

, - 284R 

H0WE3 

4321. 

50000. 

50000. 

0. 

-295 

REWF3 

9120. 

0. 

0. 

0. 

307 

C1SG3 

15700. 

0. 

0. 

0. 

Press  ENTER  key  for  CURRENT  Menu 

or  to  EDIT  values.  Type  Location  NUMBER,  Column  NUMBER  (1-  4), 
AND  "New"  VALUE;  then  Press  ENTER  key 


Figure  3 


HEC-5  EXECUTION  IN  INTERACTIVE  NODE 


WELCOME  to  Prograia  HEC-5  and  the  "Optional”  Capability 

to  "Interactively"  Display 
the  OUTPUT  RESULTS 


Messages  will  be  displayed  during  the  program's  simulation 
to  inform  you  of  the  progress  of  the  program.  When  the 
simulation  has  completed,  you  will  then  be  given  instructions 
on  how  to  display  the  results . 

Reservoir  Simulation  has  begun: 

HEC-S  Simulation  Results  have  been  computed  for: 


Period  - 

1 

of 

81  ... 

...  18 

JAN 

1959 

(2400  hours) 

_ _ _ .^.-1 

P - 

—  -  -  -  -  1 

Period  - 

40 

of 

81  ... 

. ..  23 

JAN 

1959 

(2100  hours) 

1 

Period  - 

81 

of 

81  ... 

...  28 

JAN 

1959 

(2100  hours) 

, - 

- >i 

U  •  USER  Designed  Output 
S  -  SUMMARY  of  MAXIMUM  Events 


R  -  REGULATED  Flows  by  Time  Period 

E  -  ERROR  Check  Messages 

C  -  CASE  Codes  for  Reservoir  Decisions 

T  -  TERMINATE  "Interactive"  Output  Display 

(Continue  with  H5A) 

Q  -  QUIT  Program  H5A 


Enter  letter  to  select  option: 


Figure  4 
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HEC-5  PLOTS  OF  OPERATION  RESULTS 


CLARKS  HILL  RE  FLOW-RES  IN  -  CLARKS  HILL  RE  ELEV 

CLARKS  HILL  RE  FLOW-RES  OUT 
AUGUSTA  GAGE  FLOW-LOC  CUM 
AUGUSTA  GAGE  FLOW-REG 
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